package com.example.roleplay.service;

import com.example.roleplay.domain.KnowledgeSnippet;

import java.util.List;

/**
 * 知识片段检索服务接口
 */
public interface KnowledgeService {

    /**
     * 根据查询文本检索相关知识片段
     * 
     * @param query 查询文本
     * @param maxResults 最大返回结果数
     * @return 相关知识片段列表，按相关度排序
     */
    List<KnowledgeSnippet> searchSnippets(String query, int maxResults);

    /**
     * 获取所有知识片段
     */
    List<KnowledgeSnippet> getAllSnippets();

    /**
     * 根据分类获取知识片段
     */
    List<KnowledgeSnippet> getSnippetsByCategory(String category);
}